$Id: Release-1.4.2,v 1.1 2008/03/31 00:45:57 ashnazg Exp $

PhpDocumentor Version 1.4.2
################################################################################
http://www.phpdoc.org
Gregory Beaver cellog@php.net
Joshua Eichorn jeichorn@phpdoc.org
Chuck Burgess  ashnazg@php.net
################################################################################
################################################################################

The phpDocumentor team would like to announce the release of phpDocumentor
1.4.2.  This release fixes two Windows-specific bugs, one involving usage of 
the "--ignore" option, and one involving usage of the @filesource tag.

Other minor changes are moving the install location of the "makedocs.sh" 
utility script (so that it doesn't end up in "/usr/bin" on *nix) and small
documentation updates.

------
IMPORTANT:  phpDocumentor 1.4.2 requires PHP version 4.2.0 or greater.
phpDocumentor will function best with PHP version 4.3.0 or greater, as it will
use of the tokenizer extension if php 4.3.0 is installed for a tremendous
increase in parsing speed.  PHP version 5.1.0 or newer is recommended to take
advantage of PHP5-only features.

WARNING:  A bug in PHP v5.2.1 can cause PhpDocumentor v1.3.1 and older to
spiral into an infinite loop when parsing tutorial documents.  PhpDocumentor 
v1.3.2 and newer will crash itself at the beginning of the tutorial parsing 
stage if it detects PHP v5.2.1 being used to parse tutorials.
------

Speaking of speed, do NOT run the PDF Converter with --sourcecode = on for any
medium to large sized projects.  I had to kill a PDF generation after 36 hours
on a Pentium IV 2.66GHz computer - 36 hours!  The design of the PDF generation
library is tremendously inefficient, probably on the order of O(n^2).  I'd fix
this if I knew anything about PDF.  If there are any users out there with the
time and expertise to look into the algorithms used by CPdf, we would all
appreciate it.

A full listing of all closed bugs and feature requests can be found in the 
next section of the notes.

phpDocumentor 1.4.2 is ready for production use documenting any PHP project,
download it and try the most advanced solution for PHP documentation
today.

################################################################################

The following PEAR items are included in version 1.4.2:
Bug #12361: missing links to the filesource
Bug #12699: makedocs.sh script needs a better install location
Bug #12929: paramete \'ignore\' oper mistake
Doc #12764: Update INSTALL for web docbuilder

The following Sourceforge items are included in version 1.4.2:
- [1829133] Progress display not happening until conversion finished [ashnazg]
- [1779257] ignore=.. option not working correctly on Win | fix attaced [ashnazg|mrasnika]

You can view the bug details or reopen one if
you think it's not totally fixed at:
http://pear.php.net/bugs/search.php?cmd=display&package_name%5B%5D=PhpDocumentor
http://sourceforge.net/tracker/?group_id=11194&atid=111194

################################################################################

The documentation has been updated for this release you can view it at
http://www.phpdoc.org/docs
or in the distribution in the spec directory

The changelog is available in the tarball, or online at 
http://pear.php.net/package/PhpDocumentor/download/

You can download the newest version from 
http://pear.php.net/package/PhpDocumentor/download/ 
and http://phpdocu.sourceforge.net/downloads.php

And of course you can reach the webpage at
http://pear.php.net/package/PhpDocumentor/ or
http://phpdocu.sourceforge.net/ or
http://phpdoc.org/

enjoy
-gregory beaver <cellog@php.net>
-joshua eichorn <jeichorn@phpdoc.org>
-chuck burgess  <ashnazg@php.net>


vim: set expandtab :
